Restore the operator-guide pastes that reproduce (#155) - #159
Merged
iderex merged 1 commit intoAug 21, 2026
Conversation
This does not finish #155. Two more of the path groups that commit removed are still missing. What was wrong. `d3edfc95b8526033c79cb26afe48282c2c090e32` took its tree from an older state of the default branch and landed on top of a newer one, under a message describing a change to how one workflow pin is commented. `docs/operator-guide.md` was among the seven paths it replaced, and it is the only commit to have touched that file since, so the file went back to a form whose two pastes had already been repaired. Both are back to the repaired form, and the repair is a rule-one repair rather than a preference. The exit-code paragraph quoted a `git grep -n`, and the line number in that paste is now wrong while the claim it supports is still true: git grep -n 'ExitAskedAndDeliveredNothing = ' -- internal/hardware internal/hardware/hardware.go:54:const ExitAskedAndDeliveredNothing = 3 The document on the default branch pastes that same command with `45`. Nothing about the constant changed; an edit above it moved the line, which is exactly what the removed paragraph says happens and why the command it restores carries no `-n`: git grep 'ExitAskedAndDeliveredNothing = ' -- internal/hardware internal/hardware/hardware.go:const ExitAskedAndDeliveredNothing = 3 The unknown-verb example is the second. It had been cut off after the one error line, and the runner prints the help text after it: go run ./cmd/lab frobnicate lab: unknown verb "frobnicate" lab reads this repository and reports what it examined. ... exit status 2 The restored line describes that text rather than pasting it, for the reason the restored paragraph gives: a copy of the help text in this document drifts against the runner that prints it, and the runner is what a reader is checking. What failure this prevents is an operator reading a quotation that no longer reproduces and concluding the tree, rather than the document, has moved. The blob is the bytes that were there rather than a retyping of them: git rev-parse 90656ba:docs/operator-guide.md 6775f14 git hash-object docs/operator-guide.md 6775f14 Signed-off-by: Nils Lehnen <30603423+iderex@users.noreply.github.com>
iderex
deleted the
docs/the-operator-guide-pastes-that-stopped-reproducing
branch
August 21, 2026 14:10
This was referenced Aug 21, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Refs #155
What this changes
docs/operator-guide.md, back to the bytes the default branch held at90656ba77a7c930d04d2205b2dd99df787853a92:Two pastes in that file had been repaired once and the repair is what came off.
How the absence arrived
d3edfc95b8526033c79cb26afe48282c2c090e32took its tree from an older state ofthe default branch and landed on top of a newer one, under a message describing
a change to how one workflow pin is commented. This file was among the seven
paths it replaced, and it is the only commit to have touched it since, so
nothing arrived afterwards that taking the whole blob would drop:
What failure it prevents
An operator reading a quotation in the guide that no longer reproduces, and
concluding the runner rather than the document has moved.
The first paste is the one that has already gone stale, which makes this
measurable rather than argued. The document on the default branch quotes a
git grep -nand pastes line 45. Run today it prints 54:Nothing about the constant changed. An edit above it moved the line, which is
exactly what the removed paragraph says will happen, and why the command it
restores carries no
-n. That form still reproduces:The second is the unknown-verb example, cut off after its one error line. The
runner prints the help text after that line:
The restored line describes that text rather than pasting it, and the restored
paragraph gives the reason: a copy of the help text in this document drifts
against the runner that prints it, and the runner is the thing a reader is
checking.
Nothing in this tree refuses either drift.
lab checkreads records anddecision records, not the prose of this guide, so what stands behind these two
pastes is the repair and the reason written beside it. That is a disclosure, not
a mechanism.
What was run
At
9f0c6b3ca30cf4154e58de8ba72c9fa3b11431f7, on Windows, with no graphicalsession and as an ordinary user:
go build,go vetandgofmt -leach printed nothing, which is the passingresult for all three.
The suite does not read this document, so a green run here says nothing broke
rather than that the pastes are right. The two commands above are what say that.
No test was skipped for needing elevation, and none was run with any.
What this does not do
It does not finish #155. Two path groups that commit removed are still missing:
LICENSEwith the## Licensesection ofREADME.md, and two sections ofdocs/quality-parity.md.It does not touch the second question #155 raises, which is whether anything
here should refuse a merge that removes a tracked path without saying so in its
body.
It does not move #42. What that issue landed is this file; what was missing is a
repair to two of its quotations.
No second person has read this change. The evidence above stands in place of
one, and that is a disclosure rather than an assurance.